[last updated: 2024-10-19]
WinLink home
new install 2024-10-02
-----
WinLink Blog of installation process
See Links at the bottom of the page...
-----
This is for installation on a Linux system.
On This Page:
- Get a WinLink account using a Telnet connection:
- Finish setting up your WinLink account:
- Test your account by sending an email via telnet:
- Get On the Air:
==================================
- To proceed here, you should Already Have Pat Winlink Installed and Configured.
If you do not, do this step first:
Install Pat Winlink:
-----------------------------------------------------------
Get a WinLink account using a Telnet connection:
- Create a WinLink account:
- For my installation of Pat Winlink, here are the steps I followed:
- Once Pat Winlink is installed and configured, launch pat:
with SignaLink disconnected,
in Linux terminal:
$ pat http ... this starts the client service
$ pidof pat
will return some number if pat is successfully running.
- When the client starts, it prints some status lines:
2022/05/04 20:59:52 Listening for incoming traffic on ax25...
2022/05/04 20:59:52 Starting HTTP service (http://localhost:8080)...
2022/05/04 20:59:52 Listener ax25 failed: No AX.25 ports configured
2022/05/04 20:59:52 Will try to re-establish listener in the background...
- The error: "No AX.25 ports configured" can be ignored for now, since the first step in creating a WinLink account uses a telnet connection, so the ax25 error is irrelevant for now.
- Especially note and record the localhost address listed, as this is what you'll enter into your browser to log in to WinLink.
- When the pat client launches successfully, pat will continue to run in the background and you will not have a new terminal prompt, you'll just have a blinking white square.
- Connect to WinLink via Telnet:
- open a browser to the address you set in your pat config file (under: http_addr, localhost:8080 at this time in my case)
The pat UI will open
- Connect with the system via telnet:
- click Action > Connect > select alias = telnet
click Connect (at the bottom of the Action box)
- A connection will be opened and immediately closed.
Connecting to WinLink like this, that is, without having a WinLink account in advance,
will trigger WinLink to create a new account for you.
Winlink will send a message to your Winlink inbox.
- Retrieve the message Winlink sent you:
In your pat UI, click Inbox. The new message should be there.
(single-)click the message with subject 'Your New WinLink Account'
A box will open showing the text of the message, which will include your new password (record this).
It will further tell you to go to https://www.winlink.org to:
- Your WinLink Account is now Active!
-----------------------------------------------------------
- Finish setting up your WinLink account
Edit WinLink profile:
- open browser and go to: winlink.org
Note: I found it necessary to refresh the screen on almost every Winlink.org page change, else it just hung there with a blank screen.
- log in:
My Account (top left menu bar)
enter username ([your callsign])
enter WinLink password sent to you when your account was created
(or whatever your current password is, if you've changed it since original)
- click edit
enter any name/address changes, email address, password recovery email address, etc.
click Save
- on left sidebar menu, click password change
appears to have max length of 8 chars for password
deceiving because message at the time was that change was not accepted,
but in fact it did accept the change, just truncated my 10-char entered-password to 8 chars
==============================
- Edit kpat config file:
- Open a terminal:
- Enter your password between quotes in the line:
... "secure_login_password": "[put your password here]",
-----------------------------------------------------------
- Test your account by sending an email via telnet:
- Launch pat client
- Open browser to http_addr URL (localhost:8080 on my system)
This should open your pat client UI.
- Click Action -> Compose
- Enter destination/addressee email, subject, and message
Click Post
- Click Outbox
Your new message should be there.
- Click Action -> Connect
Click drop-down at 'select alias'. Click telnet, Click Connect
- New message will disappear from Outbox
and will be listed in Sent page
- If you've sent the email to your personal email account,
be sure to check the junk folder, if it doesn't show up in your Inbox right away.
-----------------------------------------------------------
- Your WinLink account is now installed and tested.
Now: WinLink - Get on the Air
-----------------------------------------------------------
Links:
-----------------------------------------------------------
Misc notes/Addendum:
- ...At any time, use the form (lower right) to have a password re-sent to your account address. Retrieve it using your client program.
- Accounts off-air for 400 days are automatically purged. Use it or loose it!
- If after doing $ pat http, you do a ctrl-C, then pat will close/quit.
But if you do a ctrl-Z, then you'll get your terminal prompt back, but pat will still be running...
that is, $ ps will show a line for pat with its associated PID (process ID)
(sometimes for unknown reasons you have to use the command:
$ sudo ps aux | grep pat)
- If a pat process is still running, and you now re-launch with:
$ pat http, then you will get an error:
"bind: address already in use"
- To clear/kill the process:
Do $ ps and note the PID number for the pat process.
(a 6-digit number in left column)
$ kill -9 [PID]
and verify it's killed by again doing $ ps
- for Pat, cqconnect online says you also have to install:
$ sudo apt-get install ax25-tools
-----------------------------------------------------------
.
.
.
eof