go-chat

This is a simple multi user chat program written in go. It has a sister project cchat for connecting to the server.

Quick start

Initializing database

go-chat uses a postgresql to store data. This database needs to be initialized before you can run the server. To run the database locally simply connect to the postgres service on your machine, and run the file init_db.sql:

$ psql -U <username>
$ \i init_db.sql

This should create the database on your local machine and you are now ready to host the server.

Hosting the server

To host the server with the preconfigured defaults you can run the following command:

make run

If you would like to change the configuration for the server you can run the following command:

make build

and add any desired command line arguments to the executable. For more information on how to configure the server:

./gochat --help

Connecting to the server

To connect as a client you can do so with any program that allows tcp connections such as netcat, telnet or the designated cchat client. The program is by default hosted on port 8080, so if you use netcat you could connect like this assuming the server is hosted locally:

nc 127.0.0.1 8080

To connect to a remote hosted gochat server simply replace the local ip address with the remote one and everything should work like normal. For instructions on how to connect with the cchat client, see the documentation on that page.