MacIP protocol



(This page is about the VM. Checkout also the hardware MacIPpi and tinyMacIPgw ISO image)

The MacIPgw virtual machine is way of connecting your old Macintosh to the Internet. You will need a LocalTalk bridge connect the Macintosh to your network in combination with this virtual machine. Commonly used Ethernet bridges like a AsantéTalk or Dayna (mini) EtherPrint can bridge LocalTalk and EtherTalk. Even a Macintosh with a network card like a LC or SE/30 can do the job.

You can connect Macintosh computers over LocalTalk with the use of cabling between the printer ports. On this kind of network it is not possible to “speak” TCP/IP right away. To speak TCP/IP on a LocalTalk network it is necessary to encapsulate Internet Protocol (IP) packets within the AppleTalk DDP protocol. To do this right you need a piece of hardware or software to do this.
I found out that a 15 year old piece old software was recently updated by its author Stefan Bethke. I wrote him an email and he told me that the software now compiles on modern FreeBSD and Linux. On this software the MacIPgw virtual machine was originally based. Now I use the Linux port of the FreeBSD MacIP gateway implementation of Jason King. Read all about it on:

Version 3.1 is now the newest and current version of MacIPgw virtual machine (MacIPgw VM).
I publish it as VirtualBox Appliance. The file is an Open Virtualization Format Archive (.ovf)


You need three things to run the gateway:

– Virtualisation software, like Virtualbox (

– The virtual machine with macipgw on it . Download below.

– A LocalTalk bridge. Can be hardware or software.
For hardware see:
For software solution see:…&t=22036#p21405


An easy and hassle free way of getting your old Macintosh on the Internet.

Just download the MacIPgw-VM-3.1.ova file.
( 1.8G md5sum:  7ff36de76c439a607ba4292dc15befe1 )(Internet Explorer recognizes the file sometimes as a .tar. Be sure to save it as a .ova!)


Or the minimal version without all the proxies MACIPGW-3.0-MINIMAL.ova
( 696MB md5sum: 475a2d652bda11bd9ea86a75d5917f39 )
the minimal version in 7z (strong zip) file: MACIPGW-3.0-MINIMAL.ova.7z.
( 645MB md5sum: f19e29a2972fa04fddecdb4fa079b2c3 )

…..and import it in VirtualBox. This is done under File / import Appliance.
Be sure that the network device is on Network Bridge Adapter.

If you start up the virtual machine give it some minutes to boot. Specially the atalkd daemon will take some time to settle. If you login an nbplkup is done so you see all the AppleTalk devices in your network

NEW in MacIPgw virtual machine version 3.1

You can now surf the Internet without any router configuration.

Enter as your IP address in the MacTCP or TCP/IP control panel on your old Macintosh, as gateway and as your DNS and you are done. The MacIPgw VM takes care of sending your TCP packages to the Internet. You can startup your telnet session, browser or any TCP/IP application.

I have a special prepared 800K disk image which works perfect in combination with the Floppy Emu.
Or make it to a real disk with DiskCopy 4.2.

Download it here:

( 800K md5sum: e29bf1c9b0a2a745cde8e8f1b3dd9876)

You can also use a special prepared Basilisk II disk image. Boot from it and start an ancient Mosaic. Will work direct.

( 200MB md5sum: 4be8beefd845cd7d167c1dfbf8514d96)

About the MacIPgw virtual machine:

• Linux Ubuntu 16.04 Xenial32 bits
• FULL NAT on the MacIP connection. You can now surf the Internet without any router configuration
• sshd started at boot. You can login with ssh. User macipgw can login with ssh. Password is also macipgw. If you like to be root login as root or do a sudo su and enter the macipgw user password: macipgw
• telnetd started at boot. You can login with telnet. Use user macipgw and password macipgw
• Host name resolution. You can point to and it is resolved as and you can point to as your Macintosh with IP address
• motd updated. You now see a lot of information, like all the Macintosh and Appletalk devices in your network
• Small disk 1.5 GB, but can grow to 10GB
• and are now resolved by DNS
• Installed nmap for testing
• Installed aecho for testing
• Installed nbplkup for finding AppleTalk devices
• Some more old services are starting up, besides telnetd and ftpd also tftpd, finger, daytime are started. Nice for testing old MacTCP applications. For ftp login with the macipgw account with password macipgw. Or anonymous login with user anonymous and any password
• Web server on port 80 so you can test a web browser. Point it to and you will see a page telling you reaches a default web page.
• Lynx web browser. Login with telnet user: lynx and password: lynx and you will get the text only web browser so you can surf the web. No support for https however….If you close lynx your shell access will also be closed.
• Elinks web browser. Login with telnet user: elinks and password: elinks and you will get the text only web browser so you can surf the web. And yes… support for https! If you close lynx your shell access will also be closed. If you are logged in you can also type: MacWWW
• Add any package you want to add. Use apt install .. or apt-get install .. to install and apt-cache search … to find packages

MacIPgw VM File Server

Again out of the box AppleShare file sharing with Netatalk 2.2.5 installed.  If you open the Chooser you will find the “MacIPgw VM File Server”. On this server is a volume called: MacIPgw VM DISK.


Login with the macipgw credentials:

username: macipgw
passwd: macipgw

There is also a volume called Home Directory. This is the home directory of user macipgw


– HTTP 1.1 to 1.0 proxy
– Web Rendering Proxy
–  stunnel TLS Proxy ( for email clients without SSL)

HTTP 1.1 to 1.0 proxy
Starts at boot and listens on port 8082. It allows old web browsers (e.g., Netscape 0.9 or Mosaic) to communicate with modern web servers by inserting the missing “Host:” header. Many sites are hosted now on shared servers. That wasn’t the case in the old days. So one IP address had one web servers. HTTPS is not supported!

Read all about it on:
Download old browser on:

Web Rendering Proxy
If you are adventures you could try the Web Rendering Proxy. The Web Rendering proxy(WRP) is a HTTP proxy service that renders web pages in to GIF images associated with a clickable image map of the original web links. It basically allows to use historical and obsolete web browsers on the modern web.

Read all about it on:

Try or in your old browser. These two sites work perfect. It will run on port 8080 of this VM. And a development / latest on 8087 and 8088

See it in action below:




stunnel email proxy

The stunnel program is designed to work as TLS encryption wrapper between remote clients and local (inetd-startable) or remote servers. The concept is that having non-TLS aware daemons running on your system you can easily set them up to communicate with clients over secure TLS channels.

stunnel can be used to add TLS functionality to commonly used Inetd daemons like POP-2, POP-3, and IMAP servers, to standalone daemons like NNTP, SMTP and HTTP, and in tunneling PPP over network sockets without changes to the source code.

Default configuration for Gmail on board.

Read more about it on:


Let me know how you like the MacIPgw! Send me an email on macip (at)

Comments are closed.