Skip to content

Commit f840c67

Browse files
Run update.sh
1 parent 74a1782 commit f840c67

File tree

1 file changed

+33
-5
lines changed

1 file changed

+33
-5
lines changed

eggdrop/README.md

Lines changed: 33 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,29 @@ To run this container the first time, you'll need to pass in, at minimum, a nick
2424
$ docker run -ti -e NICK=FooBot -e SERVER=irc.freenode.net -v /path/for/host/data:/home/eggdrop/eggdrop/data eggdrop
2525
```
2626

27-
should be used. This will modify the appropriate values within the config file, then start your bot with the nickname FooBot and connect it to irc.freenode.net.
27+
should be used. This will modify the appropriate values within the config file, then start your bot with the nickname FooBot and connect it to irc.freenode.net. These variables are only needed for your first run- after the first use, you can edit the config file directly. Additional configuration options are listed in the following sections.
2828

29-
These variables are only needed for your first run- after the first use, you can edit the config file directly.
29+
Please note that, even in daemon mode, the `-i` flag for `docker run` is required.
30+
31+
## Environmental Variables
32+
33+
### `SERVER`
34+
35+
This variable sets the IRC server Eggdrop will connect to. Examples are:
36+
37+
```console
38+
-e SERVER=just.a.normal.server
39+
-e SERVER=you.need.to.change.this:6667
40+
-e SERVER=another.example.com:7000:password
41+
-e SERVER=[2001:db8:618:5c0:263::]:6669:password
42+
-e SERVER=ssl.example.net:+6697
43+
```
44+
45+
Only one server can be specified via an environmental variable. The + denotes an SSL-enabled port. After the first run, it is advised to edit the eggdrop config directly to add additional servers (see Long-term Persistence below).
46+
47+
### `NICK`
48+
49+
This variable sets the nickname used by eggdrop. After the first use, you should change it by editing the eggdrop config directly (see Long-term Persistence below).
3050

3151
## Long-term Persistence
3252

@@ -36,15 +56,23 @@ After running the eggdrop container for the first time, the configuration file,
3656
$ docker run -i -e NICK=FooBot -e SERVER=irc.freenode.net -v /path/to/eggdrop/files:/home/eggdrop/eggdrop/data -d eggdrop
3757
```
3858

39-
Please note that, even in daemon mode, the `-i` flag for `docker run` is required.
59+
If you provide your own config file, specify it as the argument to the docker container:
60+
61+
```console
62+
$ docker run -i -v /path/to/eggdrop/files:/home/eggdrop/eggdrop/data -d eggdrop mybot.conf
63+
```
64+
65+
Any config file used with docker MUST end in .conf, such as eggdrop.conf or mybot.conf
4066

4167
## Adding scripts
4268

43-
An easy way to add scripts would be to create a scripts directory on the host and mount it to `/home/eggdrop/eggdrop/data`. This would be accomplished by adding an option similar to
69+
An easy way to add scripts would be to create a scripts directory on the host and mount it to `/home/eggdrop/eggdrop/scripts` (or the path of your choosing). This would be accomplished by adding an option similar to
4470

71+
```console
4572
-v /path/to/host/scripts:/home/eggdrop/eggdrop/scripts
73+
```
4674

47-
to your docker run command line (and of course, don't forget to edit your configuration file to actually load it!)
75+
to your docker run command line (and then edit your config file to load the scripts from the path that matches where you mounted the scripts dir).
4876

4977
## Exposing network ports
5078

0 commit comments

Comments
 (0)