# Warg Registry Server
> ⚠️ This is prototype quality code at this time. ⚠️
## Running the server
The registry server can be started with either in-memory or PostgreSQL storage.
### In-memory storage
With in-memory storage, the server will store all data in-memory and the data
will be lost when the server is stopped.
To start the server, provide the `WARG_OPERATOR_KEY` environment variable,
which is used to sign the entries in the server's operator log:
Also, provide the `WARG_NAMESPACE` environment variable to define the initial namespace for package publishing.
```console
$ WARG_NAMESPACE=example WARG_OPERATOR_KEY="ecdsa-p256:I+UlDo0HxyBBFeelhPPWmD+LnklOpqZDkrFP5VduASk=" cargo run -- --content-dir content
2023-04-18T23:48:52.149746Z INFO warg_server::services::core: initializing core service
2023-04-18T23:48:52.170199Z INFO warg_server::services::core: core service is running
2023-04-18T23:48:52.170233Z INFO warg_server: listening on 127.0.0.1:8090
```
### PostgreSQL storage
With PostgreSQL storage, the server will store all data in a PostgreSQL
database.
Support for PostgreSQL storage is behind the `postgres` compilation feature
flag.
The easiest way to start a PostgreSQL server is with Docker:
```console
docker run -d --name postgres -e POSTGRES_PASSWORD=password -v /tmp/data:/var/lib/postgresql/data -p 5432:5432 postgres
```
With the above command, data will be stored in `/tmp/data` on the host machine.
To set up the database, install `diesel-cli`:
```console
cargo install diesel_cli
```
And run the setup with:
```console
diesel database setup --database-url postgres://postgres:password@localhost/registry
```
Here, `registry` is the database name that will be created.
To start the registry server, provide both the `WARG_OPERATOR_KEY` and
`WARG_DATABASE_URL` environment variables:
```console
WARG_NAMESPACE=example WARG_DATABASE_URL=postgres://postgres:password@localhost/registry WARG_OPERATOR_KEY="ecdsa-p256:I+UlDo0HxyBBFeelhPPWmD+LnklOpqZDkrFP5VduASk=" cargo run -p warg-server --features postgres -- --content-dir content --data-store postgres
```
The `--data-store postgres` flag starts the server with PostgreSQL data storage.
The server may now be restarted and will continue to use the same database.