Beaker: the Decentralized Read-Write Browser

The best future of the internet may be peer-to-peer. The Beaker Browser offers a glimpse.

When Tim Berners-Lee invented the World Wide Web, he envisioned a single software package that allowed everyone to create and read pages across the internet. Much has happened in the intervening years, but this idea is starting to come back.

Many of the web's founders now realize that they didn't sign up for a web dominated by a few giant corporations relying on collecting massive amounts of data on its users to sell to advertisers.

The Beaker Browser project is creating a decentralized peer-to-peer web browser that, if successful, could return the web to its users. Let's explore how this is done!

Guiding Principles

Beaker Browser serves as a bridge to a possible future for the web—and the internet. You can use Beaker today to surf the web like any other Chromium-based browser. More important, you also can use Beaker to create and support a new, decentralized, server-less internet.

Beaker Browser uses a peer-to-peer network protocol called Dat to create a decentralized web platform. Websites spread from people seeding them, BitTorrent-style. When following news and discussions about the decentralized web, you'll often hear about blockchain as an underlying basis. The Beaker team thinks that blockchain negotiations and "proof of work" requirements unnecessarily slow down the web. It's better to build "communities of trust" among peers than to try to eliminate trust altogether.

Centralized servers, internet service providers and web hosting firms restrict the options for users to collaborate with one another to build a better world. Comcast, AT&T and cable companies seek to end the principle of net neutrality to narrow the content choices users have always made on their own. At the same time, Facebook, Amazon, Google and other giant content corporations seek to keep us locked inside their respective walled gardens, persuading us that they have all the content we'll ever need. There's no need to visit the open internet. Both sides of this corporate clash do this to maximize profits for themselves.

Users deserve better, and Linux users want all the choices.

Explaining Dat

The Dat Project describes itself as "Modeled after the best parts of Git, BitTorrent, and the internet, the Dat protocol is a peer-to-peer protocol for syncing files and data across distributed networks."

Dat began as a file-sharing protocol, designed to allow users to store and share encrypted files without using centralized services like Dropbox. With the Dat Desktop app, you can make any folder on your system use the Dat protocol. Every file in that folder is encrypted with a private key. Dat also allows for storing version information for each file shared on the network.

Installing Beaker

The easy way to install v0.8 of Beaker is to head to and pick up the AppImage. You can get browsers for Mac and Windows here as well. To stay on the bleeding edge, grab and compile the latest source from GitHub:

Note: Beaker is a 64-bit application. If you run a 32-bit Linux, you're out of luck for the moment.

If you haven't used AppImage to install software yet, you may find this process smile-inducing. Just make the image file executable. You then can run it from the shell or GUI file manager. Beaker will ask to integrate with your existing desktop environment, adding itself to your app launcher for easy access.

Beaker is based on Chromium, so the user interface should be reasonably familiar. The default start page (beaker://start/) has a search dialog and a set of default Pinned Bookmarks. Following these links will give you a pretty good introduction to the Beaker project and the peer-to-peer web. Note that right-clicking on any element on a page offers an Inspect Element option to open Developer Tools. Now you're ready to browse.


Figure 1. Learn more about Beaker and the peer-to-peer web on the default Beaker://start page.

Note: the screenshots in this article were taken from Beaker on openSUSE Leap 15.

Browsing the Peer-to-Peer Web with Beaker

Entering any standard web address in Beaker will display exactly as it would in another browser, so that's not especially interesting. Where you begin to see the bridge to the future is when you look at a Dat-based page.

Start out by visiting the HTTPS-based Take a Tour intro page. On the right side of the address bar, you'll see that this page has a P2P version available. Click that button to see the Dat version of the page. The page display should be identical to the HTTPS site. The differences are subtle. The lock icon on the HTTPS site is replaced by a Share icon; click the icon for a pointer to the Beaker wiki on GitHub for more information. Because this page supports both Dat and HTTP, you'll see the inverse Go to HTTP/S version button too.

Seeding Sites

A peer-to-peer network like BitTorrent and Dat depends on individuals sharing files with each other. You don't need a server to contain all the content, just some folks willing to help out. On the right end of Beaker's address bar, you'll see another share icon, with the number of peer sites that currently are sharing this site with you. Click that icon, and you can join the peer-to-peer network, also called a swarm. By default, you're sharing the page only while you're visiting. The box tells you the size of the page. You can select a longer period of time to seed the page with the slider: a day, week, month or forever.


Figure 2. Keep this site online when you seed it on your computer.

When you seed a site, Beaker stores a read-only copy of the page in your /home directory (in openSUSE, it's inside .config/Beaker Browser). Seeded sites also go into Beaker's Library, along with the sites you make. You then can search your Library for relevant content.

Get More Information about a Site

Click the three vertical dots menu next to the shares site count to access a ton of details about the site. Choose the View Source option.

The first thing you're likely to notice is the Dat link for the page in the address bar. This is a 64-character public key identifier that never changes. The link encrypts every file being transferred, controls access to the archived files and includes version history. Whoever created the Dat link created (and stores) the private key for that link/content. This makes a Dat link more secure than even an IP address transported via HTTPS. Side benefit: you don't need to persuade system administrators to enable a new IP protocol to identify computers on a network. We have seen how the transition from IPv4 to IPv6 has gone to date.

The Files tab connects with everything connected to the page content. Click Seed to spread the site to other places. Click Make an Editable Copy to download a copy of the site (or portions of it) to edit.

Click the Network tab to identify who else is seeding the site. You can use this page to see what IP addresses are sharing, and use the Swarm Debugger to see if those sharing sites are credible and trustworthy.

Click the About tab to get a description of the site and a downloadable copy of the Favicon sitting in the corner of the browser.

Creating a Decentralized Site with Beaker

When Tim Berners-Lee invented the web, his browser also could write and edit pages. Beaker's founder, Paul Frazee, originally wanted his browser to work the same way. He quickly realized that most web developers today have their own favorite editor. Beaker still provides an editor, but you also can import web files from any editor to create a website.


Figure 3. Create and edit peer-to-peer websites. You can share files too!

To create a Dat-based website in Beaker:

  • Create your content.
  • Open Beaker.
  • From the "hamburger" menu to the right of the address bar, select Create New→Empty Project.
  • Beaker loads a Library page with a dat.json file and .datignore file.
  • Click the Title field to replace Untitled with something a little more memorable for your readers.
  • Choose a Favicon by clicking the icon to the left of the Title. Choose from the items in the menu, or Upload an icon from your system.
  • Click the + and select Import Files or Import Folder to add your content, scripts and styling files into the project folder.
  • Optional: set a local directory for your website. Go to Settings and click Set Local Folder. By default, your sites are stored in a "Sites" folder in your /home directory, with the project title (my-website). Click the pencil icon to select another directory. Be careful when choosing an existing directory, as that will become an encrypted folder. Beaker will open the selected directory in your file manager.
  • Optional: if you prefer, click New+ to create a new project folder or file. Adding a file opens an editor inside the browser.
  • Optional, but recommended: Beaker suggests you create a README file to describe your site—who you are, why this site is here, what readers will get out of it and whatever else comes to mind. Click the README button, and Beaker adds a file as you'd see in a GitHub project folder. You can use the Markdown codes to format the file. Beaker reads Markdown files into HTML automatically. You could create all your content in Markdown if you like.

These files remain on your system only until you are ready to share the site with the world (or some subset of it). You can continue writing and editing files in the project folder as long as you choose. Change the project title and Favicon on the Settings page.

Forking an Existing Site

Now you've made your website, and you want to make sure everyone sees it. And by "everyone", I mean "people who can't see Dat links". The problem is that if you enter dat:// into Firefox, the browser may deliver a Google search page. Among the results is, and you start wondering how that got there. If you already have Beaker installed, Firefox will suggest opening Dat links with Beaker.

Beaker supports the /.well-known web convention, and you can set this up to create an HTTPS version of your site. An easy way to do this is to copy some already shared files from Here's how:

  • Open the Beaker Browser Dat site.
  • Seed the site. Beaker will download the site's files into your Library.
  • Click the vertical dots and choose Make an Editable Copy.
  • Make an Editable Copy of the files in the .well-known folder (or just download them all) into your project folder.
  • Review the files inside the .well-known folder. Where there are references to, change them to your site's name.

Beaker developer Tara Vancil describes what's going on underneath like this:

Beaker piggybacks off of DNS authentication in combination with the /.well-known convention to enable dat:// shortnames. When you visit dat:// in Beaker, it sends a request to and expects to find a file that looks like this: dat://6dff5cff6d3fba2bbf08b2b50a9c49e95206cf0e34b1a48619a0b9531d8eb256/TTL=3600

Because Beaker can trust the DNS resolution, Beaker can trust that dat:// should point to dat://6dff5cff6d3fba2bbf08b2b50a9c49e95206cf0e34b1a48619a0b9531d8eb256.

Making Your Site Public

To make your new site available to readers, all you really have to do is send your site's Dat link to someone else.

Fun fact: you can share any files in your library, including the Beaker AppImage!

Sharing your link on social media will begin to generate traffic as well.

You are now part of the P2P Web!

Be aware that your website is only online when the Dat files are online. Unless someone else is seeding your site, it shuts down when your computer does. So, encourage your peers to seed forever. One way around this limitation is, "Hosting for the peer-to-peer Web".

Resources and How to Participate in the Beaker Browser

Beaker is still a project in infancy. Dat is a little further ahead, but both projects could use some help. Here are some ways you can pitch in:

  • Start by using the browser and reporting issues to GitHub.
  • Join the #beakerbrowser chat on Freenode.
  • Go to to see some important P2P sites to surf, learn and seed. It's included in the default Bookmarks on Beaker's start page.
  • Create a new Dat site of your own and share it. If you already have a site, consider mirroring it on Dat.
  • If you've got more advanced coding skills, Paul Frazee leads a weekly live coding session on YouTube every Sunday on his channel. There are many other useful videos there.
  • The Beaker APIs offer developers tools to make apps to enhance the browser.

Mike McCallister has written about Linux and FLOSS since the turn of the millennium. Find him at, Author.MichaelMcCallister on Facebook, and @workingwriter at Twitter and most everywhere else online.

Load Disqus comments