mirror of
https://github.com/go-shiori/shiori.git
synced 2025-12-16 21:59:13 +08:00
Added Docker usage to README
This commit is contained in:
parent
17844d88ae
commit
24a2b288a5
1 changed files with 43 additions and 0 deletions
43
README.md
43
README.md
|
|
@ -65,6 +65,49 @@ Use "shiori [command] --help" for more information about a command.
|
||||||
|
|
||||||
By default, `shiori` will create database in the location where you run it. For example, if you run `shiori`. To set the database to a specific location, you can set the environment variable `ENV_SHIORI_DB` to your desired path.
|
By default, `shiori` will create database in the location where you run it. For example, if you run `shiori`. To set the database to a specific location, you can set the environment variable `ENV_SHIORI_DB` to your desired path.
|
||||||
|
|
||||||
|
## Usage with Docker
|
||||||
|
|
||||||
|
There's a Dockerfile that enables you to build your own dockerized Shiori (as by now there is no official image available on Docker Hub).
|
||||||
|
|
||||||
|
### Build the image
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ docker build -t shiori .
|
||||||
|
```
|
||||||
|
|
||||||
|
### Run the container
|
||||||
|
|
||||||
|
After building the image you will be able to start a container from it;
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ docker run -d --name shiori -p 8080:8080 shiori
|
||||||
|
```
|
||||||
|
|
||||||
|
As after running the container there will be no accounts created, you need to run the following commands:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# First open a console to the container (as you will need to enter your password)
|
||||||
|
# and the default tty does not support hidden inputs
|
||||||
|
$ docker exec -it shiori /bin/sh
|
||||||
|
/go/src/shiori # shiori account add <your-desired-username>
|
||||||
|
Password: <enter-your-password>
|
||||||
|
```
|
||||||
|
|
||||||
|
And you're now ready to go and access shiori via web.
|
||||||
|
|
||||||
|
> For preserving the database, look at the next section.
|
||||||
|
|
||||||
|
### Bind the database
|
||||||
|
|
||||||
|
As you've probably noticed, if you dont preserve the database, all your bookmarks will be lost in case of rebooting/rebuilding the container.
|
||||||
|
|
||||||
|
To preserve the database you need to bind the file. In this example we're locating the `shiori.db` file in our CWD.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ docker run -d --name shiori -p 8080:8080 -v $(PWD)/shiori.db:/go/src/shiori/shiori.db shiori
|
||||||
|
```
|
||||||
|
>>>>>>> Added Docker usage to README
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
1. Save new bookmark with tags "nature" and "climate-change".
|
1. Save new bookmark with tags "nature" and "climate-change".
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue