58 lines
1.7 KiB
Plaintext
58 lines
1.7 KiB
Plaintext
---
|
|
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>
|