---
name: "axspawn.conf"
section: "5"
platform: "linux"
package: "ax25-tools"
version: "0.0.10-rc5+git20230513+d3e6d4f-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/axspawn.conf"
---

# axspawn.conf(5)

Control the operation of axspawn.

## NAME

axspawn.conf - Control the operation of axspawn.

## DESCRIPTION

The **axspawn.conf** file controls the operation of the [axspawn(8)](/axspawn/8.md) program. The operation of the config file can best be seen in an example:

\# this is /etc/ax25/axspawn.conf\
 \#\
 \# allow automatic creation of user accounts\
 create    yes\
 \# allow empty password field (so user may login via telnet, too) \[default no\]\
 create\_empty\_password       no\
 \#create\_empty\_password       yes\
 \# create with system utility [useradd(8)](/useradd/8.md)? \[default no\]\
 \#create\_with\_useradd  no\
 create\_with\_useradd  yes\
 \#\
 \# pwcheck method: password or call or group. \[default: password\]\
 \#pwcheck call\
 \#pwcheck group\
 pwcheck password\
 \#\
 \# guest user if above is 'no' or everything else\
 \# fails. Disable with "no"\
 guest     guest\
 \#\
 \# group id or name for autoaccount\
 group     hams\
 \#\
 \# first user id to use\
 first\_uid 400\
 \#\
 \# maximum user id\
 max\_uid   2000\
 \#\
 \# where to add the home directory for the new user\
 home      /home/hams\
 \#\
 \# secure homedirectories (g-rwx)\
 \#secure\_home yes\
 \#\
 \# user's shell (if not configured, it's /bin/bash, or if\
 \# create\_with\_useradd is set, useradd uses the shell\
 \# configured in /etc/default/useradd).\
 shell     /bin/bash\
 \#\
 \# bind user id to callsign for outgoing connects.\
 associate yes

The “associate” option has to be used with great care. If a user logs on it removes any existing callsign from the translation table for this userid and replaces it with the callsign and SSID of the user. This will happen with multiple connects (same callsign, different SSIDs), too. Unless you want your users to be able to call out from your machine disable “associate”.

## FILES

/etc/ax25/axspawn.conf

## SEE ALSO

[**axspawn**(8)](/axspawn/8.md).