My goal for this post isn’t to try to convince people to cycle for transportation, but I want to share everything I’ve learned to make cycling easier for others. My target audience is for new or mildly experienced cyclists for transportation in the United States. I’ll also have a small focus on Davis, California, where I went to college and a place known for bicycling.

Acquiring a Bike

The Bike You Already Have

While different bicycle designs have pros and cons, by far the best bike is the one you already have. Maybe you have one sitting around somewhere, or you can borrow one from your parents, or a friend who isn’t using theirs. If it’s in some disrepair, you can learn to fix it, or bring it to your local bike shop. It’s probably the most economical decision and involves the least commitment.

The Ideal Bike

If you are to get a new bike, a city bike has everything you need. Known as a utility bike, Dutch bike, Omafiets, or a Mamachari, this style of bike has evolved over years to be the most efficient and rugged

Here’s my Biria CitiBike, an Italian-made Dutch bike I’ve been using for 5 years strong now. Some people may confuse this style bike for a beach cruiser. While it has some similar elements, there are also some key differences.

The main benefit of a good utility bike are narrow tires. As such an efficient mode of transportation, bikes are prone to any form of resistance. While won’t go too deep into the physics principles, at the lower speeds in cycling for transportation, rolling resistance is the best optimization to make. A more narrow tire means less tire is making contact with the ground, which leads to less rolling resistance. Less rolling resistance means it’s less tiring to bike around.

Utility bikes have a comfortable sitting position. The geometry of the bike has the rider seated upright, which allows for comfort while biking longer distances. The more flat, or “sweeper”, handle bars are also much more comfortable to hold on to, and requires less weight on the riders hands.

Most utility bikes have some form of “step down” frame. This makes it quick and easy to get on and off the bike.

Utility bikes often have a lot of options for storage space. My city bike has both front and back racks. There are also lots of customization options, like front and back baskets that I have used at different times.

City bikes often have mud guards. If the roads are wet, this prevents water from coming up from the wheels and splashing you.

Some utility bikes have lights pre-installed. They have dynamos as part of the wheel assembly, which generates electricity while you bike so the light is always on. You’ll never need to remember to carry bike lights with you or charge them.

An under rated feature of utility bikes are chain guards. These help prevent clothing such as jeans from getting chewed up in the chain and gears.

Finally, durability is an important aspect of a good utility bike. While it’s harder to determine a bike’s durability at face value, check reviews and ensure you’re buying from a reputable company.

Bikes to Avoid

Brands that you might find in Walmart or Target may be cheap and convenient, but I would choose to avoid them. They are not known for their durability, and often break down at inconvenient times. If you go to a local bike shop instead, you’d be supporting a local business, have experienced people helping you make a purchase decision, and you’ll be more familiar with a place you can go for major repairs.

Similarly, buying a bike on Amazon carries similar risks. There are many discount brands where quality is difficult to determine.

If you can help it, avoid mountain bikes. The United States is obsessed with mountain bikes, and while I love them too, they don’t make good options for transportation. The wider tires and suspension system increase rolling resistance, meaning a lot more energy is expended mountain biking. If you are a fan of mountain biking, I’d recommend having two bikes that are good for each purpose, instead of one bike that isn’t very good for either.

A Used Bike

Most bikes, with some maintenance, are good for a lifetime. Buying a used bike is good for the environment, and cheaper too.

I’d look primarily at bicycle co-ops, exchanges, and bike stores specializing in used bikes. These places usually look over the bikes and make sure they are in good condition before selling them. For instance in Davis, there is the Green Bicycle Depot. In Silicon Valley, there is a cool place called the Bike Exchange, where the proceeds on bike sales go towards giving bikes to people in need.

Bike swaps and auctions are also good choices. In Davis, abandoned bikes are put up for auction, and the local elementary school has an annual bike swap. In Silicon Valley, there is a similar bike swaps and sales conducted by the Bike Exchange.

Additionally there are sites like Craigslist. However, make sure to be careful when purchasing bikes from locations like these. It’s difficult to ensure the bike is in good condition, especially when many bikes sold on these sites have been sitting for long periods of time. While you can get a good deal on these sites, many deals are to good to be true. Sites like these are the most common place for stolen bikes to be sold. Before buying, check the serial number (usually located on the bottom of the bike near the pedals) on Bike Index, and make sure it isn’t labeled as stolen. See more about bike registration.

E-bikes

Combining technology and sustainability in a fun package make e-bikes a fantastic invention. While you don’t need and e-bike, it’s certainly an option. E-bikes still get you outside, get you moving, are sustainable, and can extend your comfortable trip range.

While there are a lot of attractive cheap e-bike options out there, many are unsafe. Ensure your bike us UL 2849, ETL, or similarly certified. This ensures your bike is designed properly, and won’t spontaneously combust. Don’t be that person that buys a cheap e-bike that catches fire, and gets e-bikes banned from your apartment complex or city.

The laws for e-bikes in the United States are needlessly complex, but in most places Class 1 and Class 2 e-bikes have the same rights and responsibilities as acoustic bikes. These are limited to 20 miles per hour and 750 watts. Faster and more powerful bikes go into Class 3 or moped territory, which are more restricted. Check your local laws and make sure you know what is allowed before you buy. See more about bike laws.

When choosing between features of e-bikes, one of the main options are between hub motors and mid-drive. The mid drive option, such as a Bosch motor, is more expensive. However, it provides a really smooth riding experience. A mid-drive motor is proportional to pedal strength, where a hub motor can have some delay before it kicks in.

I think most city bicycles can handle most shopping trips just fine. However, electric cargo bikes (or “bakfiets”) are an option. They are good for much larger shopping trips, taking children with you, or an option for households looking to replace a second car. There are some mid-range options like Rad Power Bikes, or a higher end option like the Ca Go.

Riding Your Bike

The fun part!

Keep It Casual

You don’t need to be super serious about your biking. For instance, you don’t need to pedal super hard and get winded or sweaty. More effort has diminishing returns in terms of speed output, and a few miles per hour faster won’t get you to your destination much faster. Biking casually still carries health benefits as well.

Additionally, dress for the destination, not the journey. You don’t need to dress like a “cyclist”. Dressing in tight fitting clothing for aerodynamics have limited benefits at the lower speeds for transportation cycling. With a few exceptions, dress how you would normally for work, school, or wherever you’re going. That way, you can just hop off, lock your bike, and continue on with your day.

Following Bike Laws

In the United States, cyclists have the same rights and responsibilities as cars, with a few exceptions. This means you must travel on the right side of the road, stop at stoplights, yielding to pedestrians, and follow any other road rules.

In some states (though not California), people on bikes can conduct an “Idaho stop”. This is where stop signs can be treated as yield signs. This is statistically safer because it reduces the amount of time a bike spends in an intersection, which is the most dangerous place for bikes.

It usually varies city-by-city on if riding your bike on the sidewalk is legal. For instance in Davis, cycling on sidewalks is prohibited on campus, prohibited downtown, but generally permitted everywhere else. You should note that drivers generally don’t check for cyclists on sidewalks, so be careful and check behind you to see if any cars might be turning.

In California, you’re supposed to stick to the right side of the road and use the bike lane, however in a significant number of cases there are exceptions. If you’re trying to reach the left turn lane, you don’t need to stick right. If you are avoiding a hazard, you don’t need to stick right. If there’s no bike lane, you can “take the lane” if the car lane is to narrow to safely share for both a car and a bike, which is almost always the case.

Hand Signals

Cyclists, like cars, should indicate which direction they are turning. The traditional hand signals have you extend your left arm to indicate turning left, and extend your left arm as an L to indicate turning right. However, I think the traditional hand signals are confusing, antiquated, and rooted in the problematic origin of automobiles in the United States. If you want to make it more clear where you’re going, instead extend your right arm out to indicate you are turning right.

The ultimate way of indicating where you are going is pointing to where you are going. Turning right? Point right. Turning left? Point left. Exiting the roadway at that one driveway over there? Point to it! You aren’t a car, you don’t need to strictly adhere to traditional left and right signals. Pointing is quickly recognizable and provides much more clarity to where you are going.

The ABC Pre-Ride Check

The ABC pre-ride check is something I picked up from mountain biking as a kid, but I still do it because it saves me from time to time. It’s a quick 10 second check you can do before your ride. A stands for Air. Take a quick squeeze of both of your tires and make sure that they seem properly inflated. B stands for Brakes. Squeeze your front brake, and push the bike forwards. Make sure it adding stopping force. Now do the same with the other brake. Finally, C is for Chain. Do a quick visual inspection and make sure the chain and the gears it is touching look like they are where they are supposed to be.

Learn to Use Your Gears

Most bikes come with some gears, but I’ve seen a lot of people go around way too low of a gear. Learn how to shift up and down. Shifting down before you reach a hill will make it easier to climb the hill. On flats, find a nice middle gear so it’s not too hard to bike, but you’re also not spinning the pedals too much.

Bike Circles

Bike circles are roundabouts, but for bikes. You can find college students navigating these on the UC Davis campus. The rules are basically the same as a roundabout for cars. In the United States, travel goes counter-clockwise around the bike circle. People outside of the bike circle should yield to people already in the bike circle. When you leave the bike circle, move to the outside and then point to where you are exiting. Don’t be that person who goes the wrong way around the circle, or forces someone inside the circle to slam on their brakes!

Route Choice

Bike infrastructure in the United States is extraordinarily lacking. I try to avoid as much risk as possible, so the route I choose is the main thing to make my trip safer. I pre-plan my routes before I bike. I prioritize separated bike lanes, low traffic roads, and anywhere that avoids interaction with cars.

I’ve found the Transit App has pretty good biking directions that prioritize safer routes. Google Maps is okay, but usually prioritizes a more direct but dangerous route.

Biking Gear

Preparing for Weather

A lot of people have valid concerns about the weather when biking for transportation. I’ve found that if you prepare, it’s no big deal. People in countries all over the world bike in rain and snow. The only case I would avoid biking my regular route is when there is extreme heat. Just check the weather before you head out, prepare, time for the drier times, and you’ll be fine.

If you do have to bike when it is raining or snowing, you can wear a regular jacket. There are also rain ponchos designed specifically for cycling. You can also wear rain pants, but I find them a bit inconvenient.

Water proof shoes are pretty useful for cycling in weather, and just in daily life. I wear Vessi sneakers, but I’m sure there are plenty of good waterproof shoe varieties out there.

Mud guards are essential for cycling in any kind of wet weather. It prevents water from the road splashing you, and getting a stripe of mud down your back. Most good utility bicycles have mud guards pre-installed. If your bike doesn’t have mud guards, they are pretty simple to install. Make sure to cycle at lower speeds so that less water gets picked up by your tires. Also lower speeds make it easier to stop and harder to slide out on slick ground.

If you are planning on parking your bike outside and you know it is going to rain, you can cover your seat in a plastic bag while parked. Then, you can take it off before you ride and it will be dry.

Preparing for the Dark

I try to avoid biking at night, but when I do I make sure to have both front and back lights. Legally in California, you only need a front light and a back reflector at night, but exceeding that requirement is much safer. I have some USB-C rechargeable bike lights that are bright and convenient. I also carry some smaller backup lights in my bag, just in case.

The traditional bike lights give good front and back visibility, but doesn’t give very good side visibility. There are some products that you can install on your spokes or pedals that help bridge this gap. Somehow random bike light products seem to be a popular category on Kickstarter.

Helmets

Wearing a helmet is a bit of a controversial topic in the cycling community. In California they are generally not required for adults. There are some good arguments to why they should not be mandated, and in many cycling friendly countries it’s less common to see people wear helmets. However, the United States is not a cycling friendly country, and I tend to avoid risk, so I choose to wear one.

Mips is an element of helmet design that is becoming more common. Not every impact is head on, so a Mips helmet helps reduce the risk of concussion from rotational force. It’s denoted by a yellow circle on the helmet labeled “Mips”.

Not all helmets protect equally. Virginia Tech has a helmet testing lab and publishes their safety ratings. I try to stick to helmets with 5 stars. There are some listed at 5 stars for under $100.

Bike helmets are single use. If there is an impact on a helmet, it damages the foam and won’t be effective if there’s another crash. If there’s an impact on the helmet, it’s a good idea to throw it out and get a replacement.

Bike Security

I’m passionate about cyber security, and this interest lends itself to bike security too. Over years of cycling for transportation, I’ve never had my bike stolen. The main philosophy for bike security is to be as secure as possible, so that a thief may find other bikes or things to steal more opportune.

Registration

Registering a bike isn’t like a registering a car. It’s mostly an anti-theft tool. Bike Index is a non-profit that lets you register your bike for free. This registration provides legal proof that your bike is yours. Bike Index provides a systematic approach to preventing bike theft.

It’s important to report your bike stolen when if is stolen, even if you have no hope of getting it back. If you report a bike stolen to your local bike department, and then mark it stolen on Bike Index, police departments and bike shops now check if the bike is stolen. Often times police and bike shops know that a bike is stolen, but can’t do anything about it because they can’t prove it is stolen. If it’s reported, there’s a chance you can get it back. If everyone registers their bikes and marks it as stolen, then it disincentives bike theft as a whole.

It’s pretty easy and free to register your bike on Bike Index. Adding your serial number to your registration is an important part. Most bikes have their serial numbers on the bottom bracket, where the pedals attach. It’s easiest to turn your bike upside down and then record the number into Bike Index.

Choosing a Lock

For most people, a u-lock is a good primarily lock. Additionally, as portable angle grinders are getting more powerful and cheap, try to get a lock resistant to them. Do not use a cable lock as your primarily lock, as it can be cut in no time with bolt cutters. The overall goal is to delay a thief as much as possible, so a they will select another target.

Parking Your Bike

Find a good location to lock your bike. A bike rack with lots of nearby foot traffic, or a secure parking area is ideal. I also bring my bike inside when I’m able, even if I have to carry it up some stairs. I try to avoid locking my bike to railways or sign posts, as they’re not designed to be that secure, and can block accessibility. The best bike racks in my opinion are lightning bolt style, and in my opinion cities should mandate this style.

Ensure your u-lock is locked through the frame and to the bike rack. It’s best to get as much things inside the lock as possible. This helps prevent prying the lock open. In some cases, you can try to include both the frame and a wheel. You can also use a cable lock for secondary protection for your wheels, but make sure your primarily lock is around the frame. Don’t lock just a wheel, as it is easy to remove the wheel and take the rest of the bike.

Here you can see an example of a poorly locked bike I found in the wild (which I suspect was deliberately locked like this as a police bait bike). It uses a thin cable lock. It’s also not locked through the frame, and instead wrapped around the handlebars. A thief would be able to either quickly cut the cable lock, or unwrap the cable lock from around the handle bars.

Keeping Your Bike In Good Condition

Please Keep Your Tires Inflated

I see a lot of people ride around on low tires and spending a lot of extra energy. Resistance is a major concern when riding a bike, and lower tire pressures means adding rolling resistance. The correct tire pressure is usually written on the sidewall of the tire. I tend to top off my tires once a week, and I use a USB-C rechargeable bike pump.

Learn Basic Maintenance

There is a wealth of knowledge on YouTube on how to repair bikes. Knowing some basic bike maintenance is convenient, keeps your bike in good condition longer, and saves some money. You can do most repairs with a basic multi-tool and tire levers.

You can find some community bike repair places that may be able to teach you how to repair bikes. For instance, Davis has the Bike Collective.

A flat tire is a common issue to fix. You can either replace it with a new tube, or ideally you can use a patch kit to fix the existing tube. If you don’t have a stand, you can just turn the bike upside down to take the wheels off.

Cleaning your bike and putting some oil on your chain once in a while is also good for long-term reliability.

Generally your bike shouldn’t be making much noise, except for the clicking from the free wheel mechanism. If your bike is making noise, something is probably wrong. If the brakes are rubbing, they should be adjusted. If your pedaling is making squeaking noises, try adding some oil to the chain.

Carrying Things

A backpack, if you already have one, is probably the simplest way to carry things around while you’re biking. However, there are more effective ways to carry things around. You can make your bike carry your things for you.

You can get a variety of bags that are purpose built for biking. One variety is the traditional pannier. These bags are designed to attach to a bike’s rack, and are great for carrying groceries. I also use a backpack from Two Wheel Gear that transforms into a pannier bag. Recently, I’ve been trying a messenger bag as well.

Bike racks can also carry things in other ways. I sometimes carry some bungee chords with me, which make it easy to attach things to the back rack. You can also attach a basket or a milk crate to a back rack.

A good city bike has some mechanism to carry your things. You can put things in in a front basket, but if you want to carry more you can utilize a back rack. Here you can see the most things I’ve ever carried on my bike at once. I had my pannier-backpack attached to the front rack, a freezer back around the handle bars, and a box attached to the back with bungee chords.

Cycling Plus Transit Is a Powerful Combo

Taking your bike on public transit can significantly extend your range. Trains are the best, because they let bikes inside. Some busses have racks on the front that can be loaded before boarding. Just make sure to inform the driver that you’re going to take the bike off the rack when you get off. Different transit agencies have different rules, so be sure to check before making your trip. For instance, in Davis, there are two main transit agencies. Unitrans prohibits bikes on board, while YoloBus has bike front racks.

The Transit App has good bike instructions. They have a feature called Transit+, where it shows instructions for combined biking and transit trips.

Collisions

I’ve been fortunate to have a bike collision (don’t call them accidents because they are preventable). A broader look has found that the health benefits outweigh the risks. However, in the United States, poor bike infrastructure has made collisions more likely. Knowing what to do in a collision with a car is important. The main thing is to make sure to have documentation. A police report may be warranted. Make sure to get contact info of witnesses. Take as many photos, from different angles and perspectives. Visit an urgent care and make sure you’re okay. Also make sure to replace your helmet, as they are only effective for one crash.

Conclusion

Thank you for taking time to read my guide on cycling for transportation. It’s a topic I’m very passionate about. I hope that this guide helps make biking to work or school easier for you.

If you want to hear more from me, you can keep an eye on my site or subscribe to my feed.

This guide will go step-by-step on how to use matterbridge, a software designed to connect chat services together, to link Slack and Discord channels.

Note: This guide temporarily has an extra step due to Slack discontinuing “legacy” apps. This guide will be updated when matterbridge is fully updated to support “modern” Slack apps.

What You’ll Need

1. A Discord server.
2. A Slack workspace.
3. A server or computer that you can keep running and connected to the internet, preferably running on renewable electricity.
4. Docker Engine installed on the server or Docker Desktop on the computer.
5. Git installed on that server or computer.

Slack Setup

First to create a Slack app and make sure it has the proper permissions.

Make sure you are logged into your Slack Workspace, then head to the Slack API Apps page.

Click the “Create an App” button, select “From manifest”. Select the Slack workspace that you want to bridge. Then, copy and paste this configuration. This configuration file loads all the permissions that the bot needs in your workspace.

{
    "display_information": {
        "name": "My Bridge",
        "description": "A bridge between Slack and Discord",
        "background_color": "#8839ef",
        "long_description": "A friendly bot that echos conversations between Slack workspaces and Discord servers. Based off the guide from https://www.ashleybilbrey.com/posts/2025/07/03/how-to-link-discord-and-slack"
    },
    "features": {
        "bot_user": {
            "display_name": "My Bridge",
            "always_online": false
        }
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "channels:read",
                "chat:write",
                "channels:history",
                "files:read",
                "files:write",
                "groups:history",
                "groups:read",
                "im:history",
                "im:read",
                "mpim:history",
                "mpim:read",
                "users.profile:read",
                "users:read"
            ]
        }
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "channel_history_changed",
                "group_history_changed",
                "im_history_changed",
                "message.channels",
                "message.groups",
                "message.im",
                "message.mpim"
            ]
        },
        "interactivity": {
            "is_enabled": true
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
    }
}

Once you’ve created the Slack application, you should end up on the “Basic Information” page. Feel free to customize the appearance of the bot here, like name and profile image.

You’ll need two tokens to use with matterbridge. From the “Basic Information” tab, head to the “App-Level Tokens” section and click “Generate Token and Scopes”. Name your token whatever you’d like, and give it the connections:write scope. Copy and save the token you receive somewhere safe for later. It should start with xapp-.

The second token you can get from the “OAuth & Permissions” tab. Install the app using the button in the “OAuth Tokens” section. If you don’t have admin permissions, you can send the request to install the app to your workspace admin. Otherwise, approve the app.

After that, you can copy the “Bot User OAuth Token” and save it somewhere safe for later. It should start with xoxb-.

Now your Slack application should be in your workspace, like any other application or user. Make sure you invite the application to any channels you wish to bridge. An easy way to do that is to @mention the application and it should provide you with an option to add it to the channel.

Discord Setup

Now to create a Discord bot application and add it to your server.

Visit the Discord Developer Portal and log in. From there, create your bridge application.

Now, click on the “Bot” tab. Here you can do some customization of how your bot appears in channels, such as adding a profile photo. Reset your bot token and copy it and save it somewhere safe for later. It should be in the JWT format and it should look like a bunch of random characters with two dots in the middle. Additionally, you need to add the privileged intents for “Server Members” and “Message Content”.

Now get your application’s Client ID from the “OAuth2” tab. Next, visit https://discord.com/oauth2/authorize?client_id=<CLIENT_ID_HERE>&permissions=536870912&integration_type=0&scope=bot, replacing <CLIENT_ID_HERE> with the Client ID from the panel. If you don’t have admin permissions on the server you want to bridge, you can instead send the link to that server’s admin. Otherwise, continue adding the bot to the server yourself.

Your bot should now be in your Discord server. By default, most servers let your bot read and write in all channels. However if your server has custom roles and permissions, ensure the bot has the permissions to view and send messages in the channels you wish to bridge. One easy way to see if a bot is in a channel is to double check the sidebar.

Finally, we need to get the ID of the Discord server that is going to have the linked channels. Find one of the channels you wish to link and right click. Then select “Copy Link”. The link should look something like https://discord.com/channels/<SERVER_ID>/<CHANNEL_ID>. Take the Server ID between the slashes it and save it somewhere safe for later.

Server Setup

Note: This portion of the guide temporarily has an extra step building a patched version of matterbridge due to Slack discontinuing “legacy” apps. This guide will be updated when matterbridge is fully updated to support “modern” Slack apps.

First clone the kolsys fork of matterbridge. Open your terminal, or on Windows open PowerShell. Navigate to a folder you’d like to locate the project with the cd command. Then use git clone https://github.com/kolsys/matterbridge.git. to clone the matterbridge code with kolsys’s patch into the matterbridge folder. Then use cd ./matterbridge to navigate into the folder.

Make sure Docker is running, then use sudo docker build -t matterbridge-slack-patch . to build the code into an image that we can run. I have run into some out-of-memory issues building this before on one of my less powerful servers. I resolved it by adding swap space.

Create a file in the folder called docker-compose.yml with the command nano docker-compose.yml or notepad.exe docker-compose.yml on Windows. Feel free to use your favorite code editor instead (like vim), these are just the easiest options for a quick tutorial. Copy and paste this configuration file.

services:
  matterbridge:
    image: matterbridge-slack-patch
    restart: unless-stopped
    volumes:
    - ./matterbridge.toml:/etc/matterbridge/matterbridge.toml:ro
    command: ["/bin/matterbridge", "-conf", "/etc/matterbridge/matterbridge.toml"]

With nano, save by using Ctrl + O then Enter and then exit by using Ctrl + X. With Windows Notepad, save by using Ctrl + S, then exit with Alt + F4. This configuration file tells Docker how we want the image to be run in a container.

Create a file in the folder called matterbridge.toml by running nano matterbridge.toml in the terminal. Copy and paste this configuration file.

[slack]
[slack.myworkspace]
Token="xoxb-**********-*************-************************"
AppToken="xapp-*-***********-*************-****************************************************************"
PrefixMessagesWithNick=true

[discord]
[discord.myserver]
Token="**************************.******.**************************************"
Server="******************"

[general]
RemoteNickFormat="[{PROTOCOL}/{BRIDGE}] <{NICK}> "

[[gateway]]
    name = "mygateway-general"
    enable=true

    [[gateway.inout]]
    account = "discord.myserver"
    channel = "general"

    [[gateway.inout]]
    account = "slack.myworkspace"
    channel = "general"

[[gateway]]
    name = "mygateway-events"
    enable=true

    [[gateway.inout]]
    account = "discord.myserver"
    channel = "events"

    [[gateway.inout]]
    account = "slack.myworkspace"
    channel = "events"

Inside the quotes where it says Token and AppToken in the Slack section, replace it with the Slack tokens that were saved earlier. Where it says Token and Server in the Discord section, replace it with the token and server ID that were saved earlier. 🚨 As a side note, it’s important to keep these tokens safe. If these tokens were to fall into the wrong hands, someone could read private messages in your channels, or send spam. 🚨

This config file is an example that links the #general and #events channels. Customize your configuration file to use which names and channels you wish. You can also add additional gateways.

With nano, save by using Ctrl + O then Enter and then exit by using Ctrl + X. With Windows Notepad, save by using Ctrl + S, then exit with Alt + F4. This configuration file tells matterbridge the authentication tokens to log in, and which channels to link together.

You can now run everything by using the command docker compose up -d while your terminal is in the matterbridge folder. Everything should now be running! You can stop running matterbridge by using docker compose down. You can use docker compose logs to check the logs and debug if there are any errors.

Conclusion

Your Discord channels and Slack channels should now be linked 🎉! Messages you send in Discord should be replicated in Slack, and messages you send in Slack should be replicated in Discord.

With matterbridge, you can bridge more than just Slack and Discord. Visit the matterbridge wiki for more information.

Thank you to the free and open source contributors to matterbridge, and especially kolsys for making the “modern” Slack app patch. Contributors like these help keep modern technology running. Now go do something today to make the world a better place!