Setting Up asdf to Manage Node.js and Ruby on Ubuntu

Managing multiple versions of programming languages can be a headache, but asdf simplifies this process by providing a single CLI tool to manage versions of multiple runtime languages. In this article, we'll walk through the steps to install and configure asdf on Ubuntu, along with Node.js and Ruby.

Prerequisites

Before we begin, ensure that you have curl and git installed on your system. You can install them using the following command:

sudo apt install curl git

Step 1: Clone the asdf Repository

First, clone the asdf repository from GitHub into your home directory:

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0

This command checks out the version 0.14.0 of asdf. Adjust the version number as needed.

Step 2: Update Your Shell Configuration

To make asdf available in your terminal, you need to update your shell configuration. Add the following lines to your ~/.bashrc file:

. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"

After adding these lines, reload your ~/.bashrc file to apply the changes:

source ~/.bashrc

Step 3: Install Node.js

To install Node.js using asdf, follow these steps:

Install Additional Dependencies

Node.js requires some additional dependencies which can be installed using the following command:

sudo apt-get install dirmngr gpg curl gawk

Add the Node.js Plugin

Next, add the Node.js plugin to asdf:

asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git

Install the Latest Version of Node.js

You can now install the latest version of Node.js:

asdf install nodejs latest

Step 4: Install Ruby

To install Ruby using asdf, follow these steps:

Add the Ruby Plugin

First, add the Ruby plugin to asdf:

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git

Install the Latest Version of Ruby

Now, you can install the latest version of Ruby:

asdf install ruby latest

Step 5: Verify the Installation

It's important to verify that asdf has correctly installed and configured the runtime versions. You can do this by checking the output of the type -a ruby command.

• Correct Output:

    ruby is /home/username/.asdf/shims/ruby
    ruby is /usr/bin/ruby
  

• Incorrect Output:

    ruby is /usr/bin/ruby
  

If you see the correct output, it means that asdf is correctly managing the Ruby version.

Conclusion

By following these steps, you've installed asdf and configured it to manage Node.js and Ruby on your system. This setup will help you seamlessly switch between different versions of these runtimes, making your development environment more flexible and efficient.

Happy coding!

Feel free to ask any questions in the comments below or share your experience using asdf to manage different runtime versions. If you found this article helpful, don't forget to give it a thumbs up and share it with your network!