Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
Redmond desk7 min

How to Set Up a Local LLM Development Environment on Windows or Linux

A practical path to a local LLM development environment: start with Ollama on Windows or Linux, verify the local API, then add Docker, GPU support, or alternate model storage only when needed.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For the simplest local development setup, install Ollama natively on Windows or Linux, start a model, and have your application call the local HTTP API. Add WSL2, Docker, or GPU-specific configuration only when your workflow needs it. Before choosing an acceleration path, check your operating system, GPU model, driver, and available memory against the current support documentation; there is no single RAM or VRAM minimum that applies to every model and workload.

Choose a setup path before installing

Decide what you need the environment to do. A native runtime is usually the shortest path to a local endpoint for application code. WSL2 suits Windows developers who need Linux tools. Docker can isolate a runtime, but GPU access adds platform-specific requirements. Building a runtime from source is for developers who need to select or modify its backend—not a prerequisite for running a model locally.

As an Amazon Associate I earn from qualifying purchases.

  • Identify your system: note whether you are using Windows or Linux, the exact GPU vendor and model, and your available system memory, GPU memory, and disk space.
  • Start with the runtime: use a native installation unless your tooling or deployment needs call for Linux in WSL2 or a container.
  • Verify support before configuring a GPU: GPU compatibility depends on the device, driver, operating system, and backend. Do not assume that a working GPU on one path will work in another.

Ollama is one option for this setup, not the only local inference runtime. The instructions below use it because its Windows, Linux, API, and development documentation describe these paths.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How do I run an LLM locally on Windows?

Install and start with the native Windows runtime

  1. Install Ollama using its official Windows installer.
  2. Open Ollama and use its command-line or app workflow to download and run a model. Model choice and resource use vary; check the requirements for the specific model and workload rather than treating a general RAM or VRAM figure as universal.
  3. Keep the runtime running while you develop. Ollama’s Windows documentation shows a local API request to http://localhost:11434/api/generate, which application code can use to send generation requests.

For a PowerShell smoke test, the following sends a request to the documented endpoint. Enter the name of a model you have already downloaded when prompted; the request body illustrates the generate call, not the full API contract.

#1 Best Overall
Sale
havit HV-F2056 Laptop Cooling Pad for 15.6-17 Inch Laptops, Black
  • Ultra-Portable: Slim, portable, and light weight allowing you to protect your investment wherever you go
  • Ergonomic Comfort: Doubles as an ergonomic stand with two adjustable height settings
  • Optimized for Laptop Carrying: The metal mesh provides your laptop with a stable laptop carrying surface
  • Ultra-Quiet Fans: Three ultra-quiet fans create a noise-free environment for you
  • Extra Usb Ports: Extra USB port and power switch design allows for connecting more USB devices. Warm Tips: The packaged cable is USB to USB connection. Type C connection devices need to prepare an Type C to USB adapter
$model = Read-Host "Downloaded model name"
$prompt = Read-Host "Prompt"
$body = @{ model = $model; prompt = $prompt; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://localhost:11434/api/generate" -ContentType "application/json" -Body $body

For supported fields, response formats, streaming behavior, and other API operations, use Ollama’s current API documentation. This local endpoint is intended for development on the machine; the documentation cited here does not establish a complete configuration for safely exposing it to other machines.

Where Windows keeps files and logs

Ollama’s Windows documentation identifies %HOMEPATH%.ollama for models and configuration and %LOCALAPPDATA%Ollama for logs. If the service appears to start but a request fails, inspect the logs as part of diagnosis.

How do I install Ollama on Linux?

Follow Ollama’s current Linux installation instructions for your distribution, then use the documented systemd service controls. The specific installation procedure can change, so consult the current Linux guide rather than copying an old package or setup command.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Kootek Laptop Cooling Pad Cooler Stand with 5 Quiet Fans for 12"-17" Laptop
  • Whisper-Quiet Operation: Enjoy a noise-free and interference-free environment with super quiet fans, allowing you to focus on your work or entertainment without distractions.
  • Enhanced Cooling Performance: The laptop cooling pad features 5 built-in fans (big fan: 4.72-inch, small fans: 2.76-inch), all with blue LEDs. 2 On/Off switches enable simultaneous control of all 5 fans and LEDs. Simply press the switch to select 1 fan working, 4 fans working, or all 5 working together.
  • Dual USB Hub: With a built-in dual USB hub, the laptop fan enables you to connect additional USB devices to your laptop, providing extra connectivity options for your peripherals. Warm tips: The packaged cable is a USB-to-USB connection. Type C connection devices require a Type C to USB adapter.
  • Ergonomic Design: The laptop cooling stand also serves as an ergonomic stand, offering 6 adjustable height settings that enable you to customize the angle for optimal comfort during gaming, movie watching, or working for extended periods. Ideal gift for both the back-to-school season and Father's Day.
  • Secure and Universal Compatibility: Designed with 2 stoppers on the front surface, this laptop cooler prevents laptops from slipping and keeps 12-17 inch laptops—including Apple Macbook Pro Air, HP, Alienware, Dell, ASUS, and more—cool and secure during use.
  1. Install Ollama according to the current Linux guide.
  2. Start the service: sudo systemctl start ollama.
  3. Check whether it is active: sudo systemctl status ollama.
  4. If the service is not behaving as expected, inspect its journal: journalctl -e -u ollama.
  5. Once the service is running, use the local runtime from your development workflow and configure your application against its local API.

These service and journal commands are documented by Ollama’s Linux guide. A successful service status confirms the service state; it does not by itself prove that a particular model is downloaded, that a GPU is in use, or that a request will produce the output you expect.

Should I use native Windows, WSL2, or Docker?

Choose based on your toolchain and isolation needs. The paths are not interchangeable when GPU access matters.

Path Best fit GPU and operational considerations
Native Windows Windows tools and the simplest Windows setup. Use the runtime’s supported Windows GPU path for your exact device and driver; otherwise, begin without assuming acceleration.
WSL2 Windows developers who need a Linux toolchain. GPU access depends on the Windows, WSL2, driver, runtime, and container configuration. Follow the specific GPU guide rather than assuming all combinations work.
Docker Desktop on Windows Developers who want container isolation and a documented NVIDIA GPU container path. Docker’s Ollama GPU guide requires a current NVIDIA driver and Docker Desktop’s WSL2 backend for this Windows path. The guide describes GPU support for containers on Linux and Windows 11; do not read that as a guarantee for every Windows/Docker combination.
Docker Engine on native Linux Linux developers who need the Ollama runtime in a container. For the NVIDIA container flow described by Docker, install NVIDIA Container Toolkit. Docker’s guide recommends running Ollama outside a container when using Docker Desktop on a Linux machine.

If you do not need container isolation or Linux-specific tools, adding WSL2 and Docker creates extra components without being a requirement for local inference. Conversely, a container that cannot see the intended GPU may use a different execution path than you expect, so confirm device access within the chosen setup.

Rank #3
TECKNET Laptop Cooling Pad, Portable Slim Laptop Cooler for 12"-17" Laptops
  • 👍【Triple Efficient Fans】TECKNET laptop cooling pad with 3 powerful fans works at 1200 RPM to pull in cool air from the bottom to prevent your laptop, notebook, netbook, Ultrabook, Apple MacBook Pro cool from overheating during extended use or intense gaming.
  • ✌️【Easy to Use】Powered directly by your laptop's USB port, the 110mm fans operate quietly and feature a dedicated on/off switch. No external power adapter is needed.
  • 👑【Double USB Ports】One USB port can power the laptop cooler, the other one can be connected to external devices, such as keyboard, mouse, audio, etc. Blue LED indicators confirm the fans are running. Note: The included cable is USB-A to USB-A.
  • 👍【Ergonomic Comfort】Choose between two adjustable height settings to achieve a more comfortable viewing angle. Integrated rubber pads on the surface and base keep your laptop securely in place.
  • 👌【Wide Compatibility】Compatible with various laptop sizes from 12 up to 17 inches, such as Apple MacBook Pro Air, HP, Alienware, Dell, Lenovo, ASUS, etc (USB cable included). The laptop fan can also accurately dissipate heat for your tablet, router, game console.

How should I add GPU acceleration?

First confirm that the exact GPU and operating system are supported by the backend you intend to use. A GPU’s vendor name alone is not enough to determine compatibility: driver installation, runtime version, backend, and device family matter.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

NVIDIA in Docker

For the NVIDIA GPU container flow in Docker’s Ollama guide, use Docker Desktop with its WSL2 backend and a current NVIDIA driver on Windows. On native Linux with Docker Engine, the guide names NVIDIA Container Toolkit as a prerequisite. These are distinct platform instructions; do not apply the Windows Desktop steps to native Linux or assume a Linux container has GPU access merely because the host does.

AMD and ROCm

For AMD acceleration with llama.cpp, consult AMD’s ROCm compatibility information for the supported device family and the ROCm version you plan to use, and install the matching GPU driver separately. AMD documents Ubuntu and Windows configurations, but the correct route depends on the selected GPU and ROCm version. Do not install a generic ROCm package on the assumption that every AMD GPU is supported.

Rank #4
KYOLLY Ultra Slim Laptop Cooling Pad with 2 Quiet Big Fans, 5 Height Adjustable Ergonomic Stand, Portable Cooler for 10-15.6 Inch Laptops, Speed Control and 2 USB Ports
  • 【High-Speed Cooling Performance】 Equipped with two powerful fans and a precision metal mesh design, KYOLLY’s laptop cooling pad delivers optimal airflow to quickly dissipate heat, preventing overheating—even during extended use. Perfect for gaming, multitasking, or long work sessions.
  • 【Slim, Lightweight & Highly Portable】 With its ultra-slim profile and lightweight build, this laptop cooler is easy to carry anywhere. A soft blue LED indicator lets you know when the fans are active, combining style with functionality.
  • 【5-Level Height Adjustment & Anti-Slip Design】 Customize your typing and viewing angle with five ergonomic height settings. The built-in anti-slip baffles securely hold your laptop in place, making it both a efficient cooler and a reliable stand.
  • 【Quiet Operation with Smooth Speed Control】 Enjoy focused work or gameplay thanks to virtually silent fan operation. Adjust wind speed smoothly with the rolling wheel controller to balance cooling power and noise level—ideal for office or shared environments.
  • 【Universal Compatibility & Practical USB Ports】 Designed for laptops up to 15.6 inches, this cooler is perfect for home, office, or on-the-go use. Two additional USB ports offer convenient connectivity for peripherals like mice, keyboards, or phones.

If you need a source-built AMD ROCm environment, AMD’s installation material describes a prebuilt Docker image as a way to avoid installation issues and also documents a manual build path. Treat either as an advanced option, not the default first step.

Building Ollama from source

Ollama’s build documentation lists CUDA, ROCm, and Vulkan backend options. Choose the backend that matches your platform and hardware rather than enabling every option. The Windows build instructions also call for the Visual Studio Native Desktop workload. A source build is useful when you need development control; it is unnecessary just to establish a basic local runtime.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

How do I make Ollama store models on another drive?

On Windows, Ollama documents the OLLAMA_MODELS environment variable for choosing where downloaded model files are stored. Set it in your user environment to the desired model directory, then restart Ollama so the running process can use the updated setting. Use a directory on the other drive with sufficient available space.

Best Value
Sale
ChillCore Laptop Cooling Pad, RGB Lights Laptop Cooler 9 Fans for 15.6-19.3 Inch Laptops, Gaming Laptop Fan Cooling Pad with 8 Height Stands, 2 USB Ports - A21 Blue
  • 9 Super Cooling Fans: The 9-core laptop cooling pad can efficiently cool your laptop down, this laptop cooler has the air vent in the top and bottom of the case, you can set different modes for the cooling fans.
  • Ergonomic comfort: The gaming laptop cooling pad provides 8 heights adjustment to choose.You can adjust the suitable angle by your needs to relieve the fatigue of the back and neck effectively.
  • LCD Display: The LCD of cooler pad readout shows your current fan speed.simple and intuitive.you can easily control the RGB lights and fan speed by touching the buttons.
  • 10 RGB Light Modes: The RGB lights of the cooling laptop pad are pretty and it has many lighting options which can get you cool game atmosphere.you can press the botton 2-3 seconds to turn on/off the light.
  • Whisper Quiet: The 9 fans of the laptop cooling stand are all added with capacitor components to reduce working noise. the gaming laptop cooler is almost quiet enough not to notice even on max setting.

Changing the model directory is a storage and organization choice. It does not make inference faster, and the documentation does not give a universal disk-capacity recommendation. Keep model files distinct from the runtime installation when that makes backups or disk management easier.

How do I check whether my local LLM server is running?

  • On Linux: run sudo systemctl status ollama. If the service is inactive or fails, inspect journalctl -e -u ollama.
  • On Windows: use the local API endpoint shown in Ollama’s Windows documentation, http://localhost:11434/api/generate, to make a request from PowerShell or application code. A successful response shows that a request was handled; it does not establish GPU use.
  • Check the model: confirm that the model named in the request has been downloaded and that the request uses the current API format.
  • Check acceleration last: if output works but performance or device use is unexpected, verify the selected GPU backend, driver compatibility, and whether the process or container can access the intended device.

Ollama identifies Windows logs under %LOCALAPPDATA%Ollama; Linux service output can be inspected with the journal command above. Checking service state and logs before changing model prompts helps separate runtime problems from model or application issues.

What to do when setup fails

  1. Confirm that the runtime process or service is active.
  2. Read the platform logs for startup or request errors.
  3. Verify that the requested model is present and named correctly.
  4. If you expect GPU acceleration, check supported device, driver, backend, and operating-system combinations.
  5. For Docker, confirm that the container path meets the relevant host prerequisites and that the intended GPU is exposed to the container.

This order is a practical way to isolate common setup layers, not a guarantee that every failure has the same cause. Local model output and performance also depend on the model, its configuration, and the machine.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.