Welcome to the IPFire Wiki

This wiki is a community-maintained resource about everything there is to know about IPFire.

Please join in and help us improving it!

Differences in Revisions: Serial Console

Older Revision
July 15 at 9:16 pm
Remove extra backslash
# Serial Console
IPFire can be configured using a serial console - which is a common way to configure network hardware like switches and firewalls. For that, a serial cable is required. Since modern computers no longer come with a serial port, a USB-to-serial adapter can be used as well.
Connect your firewall with the serial cable and your computer first and then power it on.
## Linux
On any Linux-based computer, you can use `screen` to connect to the serial console. The command is:
`sudo screen /dev/ttyUSB0 115200`
115200 is the default baud rate for IPFire. `/dev/ttyUSB0` is most likely the device node for a USB-to-serial adapter. If you are using an actual serial port on your computer, this would be `/dev/ttyS0`.
You can leave `screen` by typing Ctrl-A K.
## Windows
[PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) is a great tool to connect to a serial console. Start it, select "Serial" as connection type and enter your serial interface as well as the baud rate of 115200. Most likely your serial interface will be called `COM3`.
## macOS
There are a number of [good tools](https://pbxbook.com/other/mac-ser.html) to connect to a serial console. [Serial](https://decisivetactics.com/products/serial/) is one of the better tools and can be downloaded directly from its website or via [Mac App Store - Serial](https://apps.apple.com/app/serial/id877615577)
Depending on the USB-to-serial adapter, a driver may need to be installed on the Mac. Information about the adapter should include a reference to the needed driver.
Launch the Serial app and in the Open Port window pick the adapter (in my case it is CP2102). Go to the menu Terminal > Settings and set the baud rate to 115200.