feat(docs): migrate documentation site into monorepo (#5912)
This commit is contained in:
1 parent
3e464a76f2
commit
9e421c67bd
605 files changed
+26764
-219
No files matched your search
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: From source
|
||||
---
|
||||
|
||||
# (Not recommended): From source
|
||||
|
||||
:::caution
|
||||
|
||||
Installing from source is a bad idea in many ways:
|
||||
|
||||
- No isolation between applications
|
||||
- Dependency conflicts on your root operating system
|
||||
- Cumbersome update process
|
||||
- Permission management
|
||||
- Handling of conflicts
|
||||
|
||||
Therefore, we highly discourage you from using this as a normal user.
|
||||
This method is only useful, when you want to develop on Homarr or extend it with your own functionality.
|
||||
|
||||
:::
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- [Node.js](https://nodejs.org/en/download/)
|
||||
- [pnpm](https://pnpm.io/installation)
|
||||
- [Redis](https://redis.io/download)
|
||||
|
||||
## Steps
|
||||
|
||||
<ol>
|
||||
<li>Clone the Repository using <code>git clone https://github.com/homarr-labs/homarr.git</code></li>
|
||||
<li>Enter the created directory using <code>cd homarr</code></li>
|
||||
<li>Install all dependencies using <code>pnpm install</code></li>
|
||||
<li>Copy the `.env.example` file to `.env` and replace `DB_URL` with the full path you want to use for the sqlite database file. For example `DB_URL='/home/username/homarr/db.sqlite`</li>
|
||||
<li>Replace `AUTH_SECRET` and `SECRET_ENCRYPTION_KEY` both with a secure random string by using `openssl rand -hex 32`</li>
|
||||
<li>Replace `CRON_JOB_API_KEY` with a secure random string by using `openssl rand -base64 32`</li>
|
||||
<li>Run `pnpm run db:migration:sqlite:run` and wait that it completes</li>
|
||||
<li>Build the source using `pnpm build`</li>
|
||||
<li>Copy better-sqlite3.node files with `mkdir build` and `cp ./node_modules/better-sqlite3/build/Release/better_sqlite3.node ./build/better_sqlite3.node`</li>
|
||||
<li>Start a redis server using `redis-server`</li>
|
||||
<li>Run the server using `pnpm start`</li>
|
||||
<li>Open `http://localhost:3000` in your browser</li>
|
||||
</ol>
|
||||
Reference in new issue
Block a user