|
|
|
@ -1,16 +1,26 @@
|
|
|
|
|
### Ubuntu
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Build requirements:
|
|
|
|
|
### Install build requirements
|
|
|
|
|
#### Ubuntu
|
|
|
|
|
```
|
|
|
|
|
sudo apt install git cargo libssl-dev pkg-config libpq-dev yarn curl gnupg2 git
|
|
|
|
|
sudo apt install git cargo libssl-dev pkg-config libpq-dev yarn curl gnupg2
|
|
|
|
|
# install yarn
|
|
|
|
|
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
|
|
|
|
|
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
|
|
|
|
|
sudo apt update && sudo apt install yarn
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Get the source code
|
|
|
|
|
#### macOS
|
|
|
|
|
|
|
|
|
|
Install Rust using [the recommended option on rust-lang.org](https://www.rust-lang.org/tools/install) (rustup).
|
|
|
|
|
|
|
|
|
|
Then, install [Homebrew](https://brew.sh/) if you don't already have it installed.
|
|
|
|
|
|
|
|
|
|
Finally, install Node and Yarn.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
brew install node yarn
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Get the source code
|
|
|
|
|
```
|
|
|
|
|
git clone https://github.com/LemmyNet/lemmy.git
|
|
|
|
|
# or alternatively from gitea
|
|
|
|
@ -20,36 +30,49 @@ git clone https://github.com/LemmyNet/lemmy.git
|
|
|
|
|
All the following commands need to be run either in `lemmy/server` or `lemmy/ui`, as indicated
|
|
|
|
|
by the `cd` command.
|
|
|
|
|
|
|
|
|
|
#### Build the backend (Rust)
|
|
|
|
|
### Build the backend (Rust)
|
|
|
|
|
```
|
|
|
|
|
cd server
|
|
|
|
|
cargo build
|
|
|
|
|
# for development, use `cargo check` instead)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Build the frontend (Typescript)
|
|
|
|
|
### Build the frontend (Typescript)
|
|
|
|
|
```
|
|
|
|
|
cd ui
|
|
|
|
|
yarn
|
|
|
|
|
yarn build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Setup postgresql
|
|
|
|
|
### Setup postgresql
|
|
|
|
|
#### Ubuntu
|
|
|
|
|
```
|
|
|
|
|
sudo apt install postgresql
|
|
|
|
|
sudo systemctl start postgresql
|
|
|
|
|
# initialize postgres database
|
|
|
|
|
|
|
|
|
|
# Either execute server/db-init.sh, or manually initialize the postgres database:
|
|
|
|
|
sudo -u postgres psql -c "create user lemmy with password 'password' superuser;" -U postgres
|
|
|
|
|
sudo -u postgres psql -c 'create database lemmy with owner lemmy;' -U postgres
|
|
|
|
|
export LEMMY_DATABASE_URL=postgres://lemmy:password@localhost:5432/lemmy
|
|
|
|
|
# or execute server/db-init.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Run a local development instance
|
|
|
|
|
#### macOS
|
|
|
|
|
```
|
|
|
|
|
brew install postgresql
|
|
|
|
|
brew services start postgresql
|
|
|
|
|
/usr/local/opt/postgres/bin/createuser -s postgres
|
|
|
|
|
|
|
|
|
|
# Either execute server/db-init.sh, or manually initialize the postgres database:
|
|
|
|
|
psql -c "create user lemmy with password 'password' superuser;" -U postgres
|
|
|
|
|
psql -c 'create database lemmy with owner lemmy;' -U postgres
|
|
|
|
|
export LEMMY_DATABASE_URL=postgres://lemmy:password@localhost:5432/lemmy
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Run a local development instance
|
|
|
|
|
```
|
|
|
|
|
# run each of these in a seperate terminal
|
|
|
|
|
cd server && cargo run
|
|
|
|
|
ui & yarn start
|
|
|
|
|
cd ui && yarn start
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Then open [localhost:4444](http://localhost:4444) in your browser. It will auto-refresh if you edit
|
|
|
|
|