about summary refs log tree commit diff
path: root/README.md
blob: f4c5d96ffc6721eeb483d64b9768c852b573072b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# sho.rest
A simple URL shortener built to be fast and easy.

>Supports up to 262144 unique three-character links, guarantees absolutely zero collisions!

### Configuring

To deploy please first create a `.env` file in the sho.rest root folder with your configuration.
You can use the `.env.example` file as a baseline.

```
POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>
PORT=<YOUR_PORT>
```

To update create and manage Diesel migrations your .env also has to have a `DATABASE_URL` variable.
This is included in `.env.example` for simplicity

```
DATABASE_URL=postgres://postgres:<YOUR_POSTGRES_PASSWORD>@localhost:5432/shorest
```

Please note that the password you pick has to be the same in both variables.

### Deploying

sho.rest is fully built and deployed using `docker-compose`.
The URL database is created and stored inside a Docker volume.

To start the necessary containers, simply run:
```sh
$ docker-compose up -d
```

You can view the results at `http://localhost:<YOUR_PORT>` in the browser of your choice!

----

Have fun!